home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / programming / other / guigfxlib / readme < prev    next >
Text File  |  2000-02-28  |  4KB  |  141 lines
  1. Short:    application layer for pixel graphics
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (bifat@neoscientists.org)
  4. Type:     dev/misc
  5. Version:  17.1
  6. Requires: Kickstart 3.0 (v39), MC68020, render.library v30
  7.  
  8.  
  9. overview
  10. -----------------------------
  11.  
  12.   - guigfx.library is an application layer for pixel graphics.
  13.  
  14.   - guigfx.library breaks the chains of all those nasty
  15.     planar, chunky, 8/16/24bit, OS3.0, OS3.1, OCS, ECS, AGA,
  16.     CybergraphX and Picasso96 considerations.
  17.  
  18.   - with guigfx.library you no longer have to take care about your
  19.     application running on a OCS machine or on a high-end
  20.     graphics-card system.
  21.  
  22.   - guigfx.library lets you freely choose truecolor graphics for
  23.     your applications.
  24.  
  25.   - with guigfx.library your graphics will always look as fine as
  26.     possible, on any screen, no matter if driven on 24 bit
  27.     1024x768 CybergraphX/Picasso96, on HAM8, or 1 bit productivity
  28.     interlaced.
  29.  
  30.   - guigfx.library does quick color-reduction, rendering,
  31.     remapping and dithering for you. only you don't know when,
  32.     on which machine, under what circumstances.
  33.  
  34.   - guigfx.library treats scaling as a standard operation.
  35.     it is available at any time, without extra consideration,
  36.     without extra memory consumption, even without a true loss
  37.     of performance.
  38.     
  39.   - guigfx.library handles screen pen allocation in an extremely
  40.     effective way.
  41.  
  42.   - guigfx.library hides bugs, incompatibilities and insufficiencies
  43.     of graphics.library, cybergraphics.library and Picasso96 from
  44.     you. it is an attempt to render incompatibilities between
  45.     different versions of CybergraphX and Picasso96 obsolete.
  46.     
  47.   - guigfx.library features picture.datatype import. standard and
  48.     v43 (including Picasso96) picture datatypes are automatically
  49.     recognized and used as available.
  50.  
  51.   - guigfx.library does not call SetFunction() and is hereby
  52.     guaranteed to never do so in future versions.
  53.  
  54.   - guigfx.library puts all that stuff into a black-box,
  55.     freeing your mind for the creative part.
  56.  
  57.  
  58.  
  59. features
  60. -----------------------------
  61.  
  62.   - full truecolor, OCS, ECS, AGA, HAM support
  63.   - screen-pen management
  64.   - color-reduction
  65.   - dithering
  66.   - picture.class datatype import
  67.   - scaling
  68.   - image processing methods 
  69.     (crop, scale, render, tint, 
  70.     alpha-channel, texture-mapping, ...)
  71.   - fully documented
  72.   - supplied with C includes for SAS/C, StormC and MaxonC
  73.   - freeware
  74.  
  75.  
  76.  
  77. requirements
  78. -----------------------------
  79.  
  80.   - render.library v30 (dev/misc/renderlib.lha)
  81.   - MC68020
  82.   - OS3.0 (v39)
  83.   
  84.   optional:
  85.   higher OS, higher CPU, FPU,
  86.   CyberGraphX or Picasso 96
  87.  
  88.  
  89.  
  90. contact
  91. -----------------------------
  92.  
  93.   bifat@neoscientists.org
  94.   http://www.neoscientists.org
  95.  
  96.  
  97.  
  98. recent changes
  99. -----------------------------
  100.  
  101. v17.1
  102.     - added an internal hook delay counter. user hooks
  103.       are now called less frequently during scaling/rendering,
  104.       which gives a slight performance boost in some
  105.       applications
  106.     
  107.     - guigfx.library no longer loses memory upon open/close.
  108.       this leak was present for eons. fixing it caused the library
  109.       itself to shrink by several kilobytes of useless object
  110.       code. no, i won't tell more details about this #*&%! one :-)
  111.  
  112.     - removed the examples from the distribution because they were
  113.       everything but instructive.
  114.  
  115. v17
  116.     - bug fixed: the drawhandle's autodither attribute
  117.       was not considered in CreatePictureBitMap().
  118.     
  119.     - added GGFX_AutoDither tag for CreatePictureBitMap()
  120.       for overriding the drawhandle's autodither tag.
  121.  
  122. v16.4
  123.  
  124.     - reconstructed 16.3 changes after a minor HD desaster
  125.  
  126. v16.3
  127.  
  128.     - bug fixed in LoadPicture(): GGFX_UseMask was broken.
  129.       memory for an alphachannel/mask was always allocated
  130.       when there was a transparency color inside the picture,
  131.       regardless of the GGFX_UseMask attribute. now an
  132.       alphachannel is only allocated when both GGFX_UseMask
  133.       is set and a mask is actually present.
  134.       
  135.     - added documentation for a feature that was present
  136.       and considered experimental since v8.3: drawing with
  137.       rotating/texture-mapping in a single pass, without
  138.       additional buffers. see: ObtainDrawHandle()/GGFX_BGColor
  139.       and DrawPicture()/RND_DestCoordinates.
  140.  
  141.